home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 11 / Cream of the Crop 11-1.iso / comm / txtq130.zip / TXTQ.DOC < prev    next >
Text File  |  1996-01-26  |  5KB  |  135 lines
  1.  
  2.  
  3.  
  4.                            TXTQ utilities, v1.30
  5.        Convert mail reader saved-message files back into .QWK packets
  6.                   Freeware, copyright (c) January 26, 1996
  7.                                      by
  8.                            David Daniel Anderson
  9.                                  Reign Ware
  10.  
  11.                   ** READ REIGNWAR.TXT FOR LEGAL TERMS **
  12.  
  13.  
  14.  
  15. Overview:
  16. ~~~~~~~~~
  17.  
  18. ROBOQ, SLMRQ and SRQ convert mail reader saved-message files back into
  19. QWK packets.
  20.  
  21.  
  22. Archive contents:
  23. ~~~~~~~~~~~~~~~~~
  24.  
  25. The TXTQ archive now includes three convertor programs:
  26.  
  27.  1) ROBOQ - converts Robomail "Text files" into .QWK packets.
  28.     (The Robomail "Text file" is any plain text file created by
  29.      Robomail's "Text File Output" command.)
  30.  
  31.  2) SLMRQ - converts SLMR ".SAV" text files into .QWK packets.
  32.     (The SLMR ".SAV" file is any plain text file created by SLMR's
  33.      "save message(s)" command.)
  34.  
  35.  3) SRQ - converts SPEED READ "save files" into .QWK packets.
  36.     (The SPEED "save file" is any plain text file created by SPEED
  37.      READ's "save message" command.)
  38.  
  39.     Note: SRQ can also read text files made with my QTXT (QWK to
  40.       TEXT) program, and convert them *back* into .QWK packets.
  41.  
  42.  
  43. Usage:
  44. ~~~~~~
  45.  
  46. RoboQ <Robomail "Text file(s)">
  47. SLMRQ <SLMR ".SAV" file(s)>
  48. SRQ <SPEED "save file(s)">
  49.  
  50.  
  51. Examples:
  52. ~~~~~~~~~
  53.  
  54. RoboQ startrek.msg
  55. SLMRQ vr5.sav
  56. SRQ babylon5.txt
  57.  
  58.  
  59. Notes:
  60. ~~~~~~
  61.  
  62.   *) DOS wildcards (*,?) are permitted in the <text file> specifications.
  63.  
  64.   *) ROBOQ.CFG, SLMRQ.CFG and SRQ.CFG are just plain text files.  They may
  65.      be edited to make changes to configurable options.  Read the .CFG files
  66.      to see if you want to make any changes to the defaults.
  67.  
  68.   *) The *.CFG files need not be used (the defaults should be fine), but, if
  69.      a .CFG file is used, it MUST be in the same dir as the executable which
  70.      it matches (the filename.EXE file).
  71.  
  72.   *) The resulting QWKs will have the same filename as the text files, but
  73.      will have a file extension of ".QWK", ".Q00", ".Q01" or similar.
  74.  
  75.   *) The text files should NOT have messages from more than one BBS, since
  76.      the resulting MESSAGES.DAT file might contain some contradictory data.
  77.      (For example, conference 71 on one BBS is probably not the same as
  78.      conference 71 on another.)
  79.  
  80.   *) If multiple conferences are included in a text file, it may help to
  81.      save them sequentially, (conference 0 followed by conference 1, etc.).
  82.  
  83.   *) Messages are limited to about 60k, longer messages will be truncated.
  84.  
  85.   *) Message numbers are not included in Robomail's "Text files", so the
  86.      ROBOQ *.QWK messages will be numbered sequentially, starting at 1 in
  87.      each conference.
  88.  
  89.  
  90. Errors:
  91. ~~~~~~~
  92.  
  93.   Most error messages are self-explanatory, but "#4" might be confusing:
  94.  
  95.   ROBOQ, SLMRQ and SRQ all look for certain delimiters and headers to decide
  96.   where one message ends and the next begins.
  97.  
  98.   Robomail uses the 3-character-long "<*>" sequence as a delimiter.
  99.   SLMR uses a 75-character-long row of equal signs (=) as a delimiter.
  100.   SPEED uses a 79-character-long row of equal signs (=) as a delimiter.
  101.  
  102.   If a delimiter is found, but a valid header doesn't follow it, then the
  103.   program will be confused, and abort.  The program will tell you where it
  104.   was in the file when it aborted by giving you an approximate line number.
  105.  
  106.   To fix the text file, alter the inappropriately placed delimiter so that
  107.   the program will ignore it.  (Either modify or delete the line.)
  108.  
  109.   Then try again.
  110.  
  111.  
  112. Revision History:
  113. ~~~~~~~~~~~~~~~~~
  114.  
  115. v1.00 - 1.02 ...     Earlier versions, distributed in separate archives.
  116. v1.10 : 1995/07/12.  Now all will build CONTROL.DAT file.
  117.                      Now ROBOQ, SLMRQ and SRQ bundled together, and archive
  118.                        includes QWKIDX11.ZIP (by Geoffrey Sy).
  119.                      Combined the shared routines from ROBOQ/SLMRQ/SRQ into
  120.                        a single unit, to minimize redundant coding.
  121.                      Lots of error prevention and error control added.
  122. v1.11 : 1995/07/16.  Only SRQ updated, to account for From/To switched.
  123. v1.20 : 1995/08/23.  Added automatic internal index building routine.
  124.                        (And removed QWKIDX11.ZIP.)
  125. v1.21 : 1995/08/24.  Now ensures a BBSID is added to CONTROL.DAT.
  126. v1.22 : 1995/09/24.  Only ROBOQ updated, to account for From/To switched.
  127.                      Fixed problem with all RoboMail messages designated #1.
  128. v1.25 : 1995/10/12.  Fixed problem with variables not being initialized for
  129.                        each new text file.
  130. v1.30 : 1996/01/26.  Fixed problem with programs not reading complete files
  131.                        because Pascal stops at End-of-File markers.
  132.  
  133.                   ** READ REIGNWAR.TXT FOR LEGAL TERMS **
  134.  
  135.